home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / sound / modman17.zip / MODMAN.DOC < prev    next >
Text File  |  1994-01-02  |  33KB  |  742 lines
  1. ▀▀█▀▀ ▄▀▀▄ ▀▀█▀▀ ▄▀▀▄ █   █  █ █     █  █ █▄  █ █   █ █▄ ▄█ █ ▀▀█▀▀ █▀▀ █▀▀▄
  2.   █   █  █   █   █▀▀█ █   █   █      █  █ █ ▀▄█ █   █ █ ▀ █ █   █   █▀  █  █
  3.   ▀    ▀▀    ▀   ▀  ▀ ▀▀▀ ▀▀▀ ▀       ▀▀  ▀   ▀ ▀▀▀ ▀ ▀   ▀ ▀   ▀   ▀▀▀ ▀▀▀
  4. ███      ███   ▄███████▄   █████████▄   ███      ███  ▄███████▄  ███     ███
  5. ███▌    ▐███  ███████████  ███████████  ███▌    ▐███ ▐█████████▌ ███▌    ███
  6. ████    ████ ▐███▀   ▀███▌ ███    ▀███▌ ████    ████ ███▌   ▐███ ████    ███
  7. ████▌  ▐████ ███▌     ▐███ ███     ▐███ ████▌  ▐████ ███     ███ ████▌   ███
  8. █████  █████ ███       ███ ███      ███ █████  █████ ███     ███ █████   ███
  9. █████▌▐█████ ███       ███ ███      ███ █████▌▐█████ ███▄▄▄▄▄███ █████▌  ███
  10. ████████████ ███       ███ ███      ███ ████████████ ███████████ ██████  ███
  11. ███▐████▌███ ███       ███ ███      ███ ███▐████▌███ ███▀▀▀▀▀███ ██████▌ ███
  12. ███ ████ ███ ███       ███ ███      ███ ███ ████ ███ ███     ███ ███▐███ ███
  13. ███ ▐██▌ ███ ███       ███ ███      ███ ███ ▐██▌ ███ ███     ███ ███ ███▌███
  14. ███  ██  ███ ███       ███ ███      ███ ███  ██  ███ ███     ███ ███ ▐██████
  15. ███  ▐▌  ███ ███       ███ ███      ███ ███  ▐▌  ███ ███     ███ ███  ██████
  16. ███      ███ ███       ███ ███      ███ ███      ███ ███     ███ ███  ▐█████
  17. ███      ███ ███       ███ ███      ███ ███      ███ ███     ███ ███   █████
  18. ███      ███ ███▌     ▐███ ███     ▐███ ███      ███ ███     ███ ███   ▐████
  19. ███      ███ ▐███▄   ▄███▌ ███    ▄███▌ ███      ███ ███     ███ ███    ████
  20. ███      ███  ███████████  ███████████  ███      ███ ███     ███ ███    ▐███
  21. ███      ███   ▀███████▀   █████████▀   ███      ███ ███     ███ ███     ███
  22.  
  23.   ░░▒▒▓▓████████     T O T A L L Y   U N L I M I T E D     ░░▒▒▓▓████████
  24.  
  25.   ▓▓████  ██████       *   M O D M A N   v 1 . 7   *       ▓▓████  ██████
  26.       ██  ██                                                   ██  ██
  27.   ██  ██  ██  ██              (c) 1994.01.02               ██  ██  ██  ██
  28.   ██  ██  ██  ██                                           ██  ██  ██  ██
  29.   ██  ██████  ▓▓   by Tom Rathborne of Totally Unlimited   ██  ██████  ▓▓
  30.   ██          ▒▒                                           ██          ▒▒
  31.   ████████▓▓▒▒░░            MODMAN is Freeware!            ████████▓▓▒▒░░
  32.          ^                                                       ^
  33.          │    (but if you like it, you can still send money!)    │
  34.          │                                                       │
  35.          └────── My neat logo encompassing the T and the U ──────┘
  36.  
  37.                 Portions (C) Copyright 1992-1993 Andy Hakim
  38.  
  39.   ┌──────────╖
  40. ──┤ CONTENTS ╟─────────────────────────────────────────────────────────────
  41.   ╘══════════╝
  42.  
  43.         ABOUT MODMAN
  44.  
  45.         USING MODMAN
  46.         THE CONFIGURATION FILE
  47.  
  48.         FORMATS SUPPORTED
  49.  
  50.         ABOUT THE AUTHOR
  51.         OTHER STUFF
  52.         THANKS
  53.         FUTURE FEATURES
  54.         HISTORY
  55.  
  56.   ┌──────────────╖
  57. ──┤ ABOUT MODMAN ╟─────────────────────────────────────────────────────────
  58.   ╘══════════════╝
  59.  
  60.     MODMAN is a great program. I'm really proud of it. Believe me, you have
  61.     to try it! I use it all the time to make cassette tapes of my module
  62.     collection! Since it's freeware, it doesn't benefit me one bit if you
  63.     use it.
  64.  
  65.     * Send me your ideas and I'll do my best to put them into MODMAN! *
  66.  
  67.     On the PC scene, there are tons of different formats of .MOD (Module)
  68.     music files. Along with these formats are a whole bunch of players.
  69.     Some players can play only a few module formats, some can play many.
  70.     Some modules can be played by most players, some can only be played by
  71.     one or two. MODMAN allows you to quickly and easily select from a
  72.     directory of modules, associating each module with a player that
  73.     supports it. Then it makes a batch file and plays your selections.
  74.  
  75.     I've tried quite a few other mod-selection programs. MODShell is okay.
  76.     DMPShell is very good, but I wasn't satisifed. I think MODMAN blows all
  77.     of them away. I know you'll agree.
  78.  
  79.     Configuring MODMAN is a little complicated. I have included lots of
  80.     sample configurations for you to fiddle with. Basically, it's all set
  81.     up in the sample MODMAN.CFG - you just have to remove the players that
  82.     you don't have, and add the ones that you do!
  83.  
  84.     MODMAN takes up exactly 0k of RAM while playing MODs! A batch file runs
  85.     MODMAN, which creates a temporary batch when you have selected your
  86.     modules. Then the first batch file runs the temporary batch file which
  87.     plays your MODs. This leaves plenty of RAM free for your players.
  88.  
  89.     Although MODMAN takes up 0k of RAM while playing, yes that's right NO
  90.     RAM, the memory requirements of MODMAN (while running) will vary
  91.     depending on the number of MODs you have in one directory. The maximum
  92.     number that MODMAN will read in one directory is 1024. If anyone has
  93.     more than that in one directory, let me know and I can tell you to make
  94.     some subdirectories. I don't anticipate any memory allocation errors.
  95.  
  96.     MODMAN is, of course, freeware! That means you can copy MODMAN all you
  97.     want, as long as you don't modify it, and you include these files:
  98.  
  99.     MM.BAT
  100.     MODMAN.CFG
  101.     MODMAN.DOC
  102.     MODMAN.EXE
  103.     FILE_ID.DIZ (Please make sure that this description gets into the
  104.                  BBS file listing if you upload MODMAN to a BBS.)
  105.  
  106.     Support freeware by using and distributing it! Of course, if you have
  107.     any questions or comments, or if you think MODMAN is worth a few $,
  108.     [especially if you want to send money... :-)] please contact me.
  109.  
  110.   ┌──────────────╖
  111. ──┤ USING MODMAN ╟─────────────────────────────────────────────────────────
  112.   ╘══════════════╝
  113.  
  114.                     DON'T RUN MODMAN.EXE - RUN MM.BAT!
  115.                         MODMAN requires a VGA card.
  116.  
  117.     MM.BAT runs MODMAN and then plays any modules that were selected. Don't
  118.     run MODMAN.EXE by itself.
  119.  
  120.                               *** ESC TO EXIT ***
  121.                               *** F1 FOR HELP ***
  122.  
  123.     As of version 1.3, MODMAN uses a custom font, and does various neat
  124.     things to your VGA card. Everything should go back to normal when it
  125.     exits. If anything DOESN'T go back to normal, please let me know.
  126.  
  127.     When you exit MODMAN, it will leave you in 50-line mode if that's the
  128.     mode you started in, but if you started in anything less than that,
  129.     then you will be returned to 25-line mode. Feel free to edit MM.BAT to
  130.     do whatever you want to your sound or video options. Make sure you keep
  131.     a copy of the original just in case you make a mistake!
  132.  
  133.     MODMAN is simple to use. All keys are listed on the right of the
  134.     screen, and a more detailed keyboard reference is available by pressing
  135.     F1 then F2. Here's a sample of the important part of the screen...
  136.  
  137.     [ A "B" to the left of a line means that line has a blue background.
  138.       An "R" to left means that line has a red background. Remember that
  139.       a red and blue background makes magenta.                            ]
  140.  
  141.     ══════════════╦════════════════════════════════════════════════════════
  142.      Directory ═> ║ C:\MODS
  143.     ══════════════╬══════════════════════╤═══════════════════════════╤═════
  144.      Module file  ║ Module Title         │ Module Format             │Seq.#
  145.     ──────────────╫──────────────────────┼───────────────────────────┼─────
  146. B    MOONSNTA.669 ║ Moonlight Sonata...  │ Composer 669 Module       │  1
  147. B    CANONMIX.AMF ║ Johann Pachelbel     │ Advanced Module Format    │  3
  148. BR   GONADSCR.MOD ║ Gonads Cracks        │ ProTracker                │  2
  149.      PLASTIC .S3M ║ World of plastic     │ Scream Tracker 3 Module   │
  150.     ══════════════╬══════════════════════╧═══════════════╤═══════╤═══╪═════
  151.      Player file  ║ Player Name & Description            │Version│OK?│Used#
  152.     ──────────────╫──────────────────────────────────────┼───────┼───┼─────
  153.  R   DMP     .EXE ║ Dual Module Player                   │ 2.60ß │ √ │  2
  154. B    WOWII   .EXE ║ WOW ][ Module player                 │ 1.31  │ √ │  1
  155.      MP      .COM ║ ModPlay Pro                          │ 2.19b │ √ │
  156.     ══════════════╩══════════════════════════════════════╧═══════╧═══╧═════
  157.  
  158.     In this example, the first three modules are marked.
  159.     - indicated by blue background
  160.  
  161.     First is MOONSNTA.669, then GONADSCR.MOD, then CANONMIX.AMF.
  162.     - indicated by numbers in Seq.# column
  163.  
  164.     GONADSCR.MOD is the currently selected file.
  165.     - indicated by red background
  166.  
  167.     GONADSCR.MOD can be played by any of the three players
  168.     - indicated by three checkmarks in OK? column
  169.  
  170.     GONADSCR.MOD is scheduled to be played by WOW][.
  171.     - indicated by blue backround on WOW][
  172.  
  173.     If you press space once here, GONADSCR.MOD will be unmarked (deleted
  174.     from the sequence, loses blue background) and the red bar will move
  175.     down to PLASTIC.S3M. If you press space again, PLASTIC.S3M will be
  176.     marked, using DMP.
  177.  
  178.     At the very top you see the Directory. This is the current directory of
  179.     modules that is being displayed.
  180.  
  181.     Below that is the list of Modules. The filename, title, and format are
  182.     displayed. If a file in the current directory cannot be identified,
  183.     or if there is no player in the configuration file that can play it,
  184.     then it will not appear in the list. The "Seq.#" column shows the
  185.     number of that module in the sequence. This column will be blank if the
  186.     module has not been selected.
  187.  
  188.     At the bottom of the screen is the list of Players. The player file
  189.     (BAT EXE or COM), description, and version are displyed. These are read
  190.     from the MODMAN.CFG file. See THE CONFIGURATION FILE for more information
  191.     on this file. The "OK?" column will have a checkmark if the selected
  192.     module can be played with that player. This information is also
  193.     contained in the configuration file. The "Used#" column shows how many
  194.     times the player has been used in the sequence.
  195.  
  196.     It's all very intuitive (I hope!), so just run the program and press:
  197.     F1 then one of: F2/space/PgDn/2 for help on the keys. If anyone tells
  198.     me that it doesn't make sense, I will write some better docs for this
  199.     part. Even better, YOU write the docs and send them to me.
  200.  
  201.     Please refer to the third page of help for the mouse features.
  202.  
  203.   ┌────────────────────────╖
  204. ──┤ THE CONFIGURATION FILE ╟───────────────────────────────────────────────
  205.   ╘════════════════════════╝
  206.  
  207.     The configuration file for MODMAN is called MODMAN.CFG. To find this
  208.     file, MODMAN first checks for an environment variable called MODMANCFG.
  209.     This environment variable should NOT include "MODMAN.CFG".
  210.  
  211.     RIGHT: "SET MODMANCFG=C:\MODS"
  212.     RIGHT: "SET MODMANCFG=C:\MODS\"
  213.  
  214.     WRONG: "SET MODMANCFG=C:\MODS\MODMAN.CFG"
  215.  
  216.     If you want to save environment space, simply put a SET command for
  217.     MODMANCFG before MODMAN in MM.BAT, then put a "SET MODMANCFG=" after
  218.     MODMAN to remove it. Then all you have to be sure of is that MM.BAT is
  219.     in the path.
  220.  
  221.     If there is no MODMANCFG environment variable, MODMAN checks the
  222.     current directory, then all the directories in the PATH environment
  223.     variable.
  224.  
  225.     As for the MODMAN.CFG file itself, put a line with just
  226.     "[MODMANCONFIG]" on it, then the number of players, then the default
  227.     player to use, then a line with just "***", and then the info for the
  228.     first player, etc.
  229.  
  230.     Here's an example of a very simple MODMAN.CFG file, configured for just
  231.     DMP:
  232.  
  233. [MODMANCONFIG]
  234. 1
  235. 1
  236. ***
  237. Dual Module Player
  238. 2.78
  239. DMP.EXE
  240. @
  241. 1 2 3 4 5 6 7 8 9 11 12 14 15 27
  242.  
  243.     The sample MODMAN.CFG file included with MODMAN has all the information
  244.     you need to configure MODMAN! In case you lost it, here's the
  245.     information from MODMAN.CFG:
  246.  
  247. ───────────────────────────────────────────────────────────────────────────
  248.  
  249.     Anything before the line that starts with [MODMANCONFIG] is a comment.
  250.     After that, you have to follow the config format strictly. Putting a ~
  251.     on a line will make MODMAN ignore everything after it. To comment out a
  252.     whole line, the first character must be a ~.
  253.  
  254.     Any lines after [MODMANCONFIG] that do not belong will cause errors if
  255.     they do not start with a ~. This means that you can't have any blank
  256.     lines. If you want to add space to make the file more readable, just
  257.     add a few lines with a ~ and nothing else on them.
  258.  
  259. *** CONFIG FILE FORMAT
  260.  
  261. Starting after [MODMANCONFIG] line:
  262.     line 1: number of players - up to 39
  263.     line 2: default player to use on startup. If you use a number larger
  264.             than the number of players, the default will be 1.
  265.  
  266. Then the player records:
  267.     There must be *at least* as many player records as the number of
  268.     players specified on the first line. If the file ends too early, you'll
  269.     get an error message. If there are more players in the file than you
  270.     have specified, the ones at the end just won't be shown.
  271.  
  272.     line 1: '***'
  273.     line 2: Description of player    - up to 36 characters
  274.     line 3: Version of player        - up to  5 characters
  275.     line 4: Command (EXE/COM/BAT)    - up to 80 characters
  276.                 The first 13 characters up to the first space character
  277.                 will be displayed on the screen, split at the '.'.
  278.                     i.e. "DMP.EXE -s22050"
  279.                     Will appear as "DMP     .EXE" on the screen
  280.                     And in a batch file: "DMP.EXE -s22050 @MM0.LST"
  281.  
  282.     line 5: Maximum number of MODs on one command line
  283.                 If a player is used more than once in a row in the
  284.                 sequence, the batch file will pass (at most) this number of
  285.                 mods all on one command line. Use @ or 0 to tell MODMAN to
  286.                 generate a @listfile instead. It will be passed like this:
  287.                 "[info on line 4] @MM0.LST"
  288.  
  289.     line 6: Module formats supported - up to 80 characters
  290.  
  291.             Here's what each number means:
  292.  
  293.                NOTE THAT THE NUMBERS WERE ALL CHANGED AROUND BETWEEN
  294.                VERSION 1.1 and 1.2! Sorry for the inconvenience, but it was
  295.                for the best, believe me...
  296.  
  297.                (* = supported by most players)
  298.  
  299.           * 1  SoundTracker - 15 instruments
  300.           * 2  ProTracker
  301.           * 3  ProTracker with more than 64 patterns
  302.           * 4  Tracker - ModEdit
  303.           * 5  Tracker - KingMOD
  304.           * 6  StarTrekker - 4 channels
  305.             7  StarTrekker - 8 channels
  306.             8  FastTracker - 6 channels
  307.             9  FastTracker - 8 channels
  308.             10 OctaCompositor 8 channels
  309.             11 Scream Tracker 3 Module
  310.             12 ScreamTracker Module
  311.             13 ScreamTracker Song
  312.             14 Composer 669 module
  313.             15 Advanced Module Format
  314.             16 Oktalyzer
  315.             17 UltraTracker Module
  316.             18 Future Composer [FC14]
  317.             19 Future Composer [SMOD]
  318.             20 MED file
  319.             21 Some sort of MED file
  320.             22 OctaMED file
  321.             23 SMUS v.2 Module
  322.             24 Face the Music format
  323.             25 StarTrekker - 6 channels
  324.             26 Audiovision/ROM
  325.             27 MultiTracker Module
  326.  
  327.   ┌───────────────────╖
  328. ──┤ FORMATS SUPPORTED ╟────────────────────────────────────────────────────
  329.   ╘═══════════════════╝
  330.                                                             Typical
  331.     Author Origin             PC?  Type / Program           Extension
  332.    ┌────────────────────────┐ ┌─┐ ┌──────────────────────┐ ┌─────────┐
  333.     Standard Amiga Trackers    *   15-channel SoundTracker  MOD, NST
  334.  
  335.     Mahoney & Kaktus           *   ProTracker               MOD, NST
  336.                                *   ProTracker 64+ pattern   MOD, NST
  337.  
  338.     Maxon Computer GmbH            Face the Music (Amiga)   FTM
  339.  
  340.     Various other Trackers     *   StarTrekker 4 channel    MOD, NST
  341.                                    StarTrekker 6 channel    MOD, NST
  342.                                *   StarTrekker 8 channel    MOD, NST
  343.                                *   Oktalyzer                OKT
  344.                                    MED [two flavours]       MED
  345.                                    OctaMED                  OCT
  346.                                    FutureComposer [FC14]    FC3
  347.                                    FutureComposer [SMOD]    FC3
  348.                                    SMUS module              MUS
  349.  
  350.     Fredrik Huss               *   FastTracker 6 channel    MOD, 6CM
  351.     (Mr. H/Triton)             *   FastTracker 8 channel    MOD, 8CM
  352.  
  353.     AJGG Graveland             *   OctaCompositor           OCT
  354.  
  355.     Sami Tammilehto            *   ScreamTracker Module     STM
  356.     (Psi/Future Crew)          *   ScreamTracker Song       STS
  357.                                *   ScreamTracker 3 Module   S3M
  358.  
  359.     Tomasz Pytel               *   Composer 669             669
  360.     (Tran/Renaissance)
  361.  
  362.     Daniel Goldstein           *   MultiTracker Module      MTM
  363.     (Starscream/Renaissance)
  364.  
  365.     Otto Chrons                *   Advanced Module Format   AMF
  366.  
  367.     Marc André Schallehn       *   UltraTracker (for GUS)   ULT
  368.  
  369.     Christopher E. Kingsbury   *   Edited by KingMod        MOD
  370.  
  371.     Norman Lin                 *   Edited by ModEdit        MOD
  372.  
  373.     Brian Czapiga (PiXeLiTe)   *   AudioVision/ROM          ROM
  374.    └────────────────────────┘ └─┘ └──────────────────────┘ └─────────┘
  375.  
  376.     The types marked with a "*" in the list can be played by at least one
  377.     PC player. Note that the KingMod and ModEdit files are standard
  378.     ProTracker modules. They should be supported by any standard ProTracker
  379.     player.
  380.  
  381.     You only get the first 20 characters of the title in Composer 669 and
  382.     MED/OctaMED songs.
  383.  
  384.     I can't seem to find any FutureComposer modules with titles so I'm not
  385.     sure where to find the titles. I have the same problem with many MED
  386.     types. "Unknown:[filename]" appears as the title in these cases. In
  387.     the case of ROM files, there actually is no title in the file.
  388.  
  389.     If the file has the correct signature, but the title includes control
  390.     characters (less than ASCII 27), the title will appear as "[ Might be
  391.     corrupt ]"
  392.  
  393.   ┌──────────────────╖
  394. ──┤ ABOUT THE AUTHOR ╟─────────────────────────────────────────────────────
  395.   ╘══════════════════╝
  396.  
  397.     Totally Unlimited is my (and a friend's - Chris Wright - but he can't
  398.     program his way out of a wet paper bag [Sorry Chris! :-) ]) little
  399.     company name. You can't have it. Stamped it! Whenever I write something
  400.     I think someone else would like, I release it under this name.
  401.  
  402.     I'm a first year co-op Math student at the University of Waterloo.
  403.     If you want to offer me a co-op job, I'd be glad to have the job-search
  404.     process simplified for me. :-)
  405.  
  406.     I don't have a PC yet in my room at University, so you shouldn't expect
  407.     too many versions in the next five years! I may only buy a computer
  408.     when I can get the very best machine on the market... perhaps a PowerPC
  409.     running Linux! :-)
  410.  
  411.     You can contact me via Internet mail, Paper mail, or Telephone!
  412.  
  413.     I appreciate:
  414.  
  415.         Bug reports
  416.         Information on more file formats
  417.         Suggestions
  418.         Comments
  419.  
  420. *** Internet address:
  421.  
  422.         twrathbo@undergrad.math.uwaterloo.ca
  423.  
  424.     Use finger/mail/talk!
  425.  
  426.     I will be uploading MODMAN/MODUTILS to various FTP sites. The docs are
  427.     available on the University of Waterloo Gopher server. Finger or email
  428.     me for information on the latest versions, FTP sites, Gopher info, etc.
  429.     I normally reply to my mail immediately, so if I'm online when the mail
  430.     comes in, you just might receive a reply within the hour! If you finger
  431.     me and I'm online, feel free to request a "talk" session!
  432.  
  433.     The latest MODMAN/MODUTILS will be available via anonymous FTP from
  434.     ftp.uwp.edu in pub/msdos/modplayers or pub/incoming/modplayers.
  435.  
  436. *** Geographical address:
  437.  
  438.         Tom Rathborne
  439.         132 Leland Rd.
  440.         London, Ontario
  441.         N6K 1T3
  442.         CANADA
  443.  
  444.     This is my home address. Any mail sent to me here will find its way to
  445.     me wherever I am!
  446.  
  447. ***  Phone:
  448.  
  449.         (519) 725-9783
  450.  
  451.     This is my telephone number at the University of Waterloo. It will be
  452.     valid until May 1994. Call anytime! I have voicemail (and a roommate)
  453.     so leave a message if I am not around and I'll call you back (but maybe
  454.     only for a short time if it's a very long distance call!)
  455.  
  456. *** Other:
  457.  
  458.     You can probably track me down somewhere else electronically. Address
  459.     any messages to "Tommy Rathborne" - my name macro hasn't changed in
  460.     years! As for big boards, try The Sound Barrier in New York. The 14.4k
  461.     DS number there is (718) 979-6629. I don't call there often anymore,
  462.     though.
  463.  
  464.   ┌─────────────╖
  465. ──┤ OTHER STUFF ╟──────────────────────────────────────────────────────────
  466.   ╘═════════════╝
  467.  
  468. *** Technical details
  469.  
  470.     MODMAN was created and compiled with Borland C++ 3.1, using the Compact
  471.     memory model, and lots of inline assembler for the video. There
  472.     shouldn't be any memory allocation errors. Source code is not currently
  473.     available. Sorry.
  474.  
  475. *** The Smooth Mouse Driver
  476.  
  477.     Because MODMAN is freeware, the Smooth Mouse Driver (SMD) libraries
  478.     were supplied to me by Andy Hakim, *free of charge*, through Eric
  479.     Coolman. Thanks Andy!
  480.  
  481.     Here's some info on the libraries, and how to contact Andy, straight
  482.     from his documentation: (this may be a bit out of date...)
  483.  
  484.     The SMD library provides a bitmapped graphics-style mouse cursor in
  485.     ega/vga text modes. It is implemented as an extension to the regular
  486.     Microsoft mouse driver. The programmer has the convienience of using
  487.     all interrupt 33h based mouse function calls while utilizing the new
  488.     mouse cursor.
  489.  
  490.                      │
  491.              US Mail │ Andy Hakim
  492.                      │ 816 Pecore Street
  493.                      │ Houston, TX 77009-6034
  494.                      │ U.S.A.
  495.                      │
  496.            Telephone │ +1 713-880-3059
  497.                      │
  498.             Internet │ ahakim@uh.edu
  499.        DECnet/THEnet │ uhou::ahakim
  500.                      │
  501.       CompuServe and │ Send a message to the Internet address listed
  502.             MCI Mail │ above.
  503.                      │
  504.             FTP site │ karazm.math.uh.edu (129.7.128.1)
  505.            directory │ /pub/Incoming/PP/
  506.                      │ Use login name "anonymous" and give your email
  507.                      │ address for the password.
  508.                      │
  509.       Bulletin Board │ Sands BBS
  510.                      │ +1 713-961-1604
  511.                      │ 2400 through 16800 baud, HST/v.32bis
  512.                      │ Use login name "precise point" and "mouse" for
  513.                      │ the password. To send Andy a message, address it
  514.                      │ to "Andy Hakim"
  515.                      │
  516.  
  517. *** MODUTILS - My other Module-related programs:
  518.  
  519.     The three MODUTILS will list directories describing modules with titles
  520.     and formats. MODDIR works like a very simple DIR command, MODNAMES
  521.     creates a 4DOS/NDOS DESCRIPT.ION file, and MODDIZ creates a FILE_ID.DIZ
  522.     for SysOps.
  523.  
  524.     Look for TUMODU36.ZIP on your local BBS - it was released at the same
  525.     time as MODMAN 1.6!
  526.  
  527. *** The Mysteries:
  528.  
  529.     Answer these questions for me, and get your name in the thanks section!
  530.  
  531.     1. Where can I find the title in FutureComposer and MED modules?
  532.  
  533.     2. How can I identify 15-instrument files better?
  534.        (right now I look for one single character in a certain position,
  535.         which means that any file that happens to have that character there
  536.         will be identified as a 15-instrument format file!)
  537.  
  538.     3. What makes a WOW file unique? I can't figure out how to tell them
  539.        apart from normal MODs! In fact, the MODUTILS recognize WOW files as
  540.        normal MODs.
  541.  
  542.   ┌────────╖
  543. ──┤ THANKS ╟───────────────────────────────────────────────────────────────
  544.   ╘════════╝
  545.  
  546. Format thanks:
  547.  
  548. ... to Fredrik Huss (Mr. H/Triton) for the information in the help text of
  549.     FastTracker 1.1 which helped me to identify the SoundTracker,
  550.     NoiseTracker, ProTracker, FastTracker, StarTrekker, and
  551.     OctaCompositor formats.
  552.  
  553. ... to Edward Schlunder in the FidoNet QB conference for the info on
  554.     ProTracker & StarTrekker and ProTracker modules with more than 64
  555.     patterns.
  556.  
  557. ... to Mark Phipps (Rittmeister RedOctober/Starry Knights) for sending the
  558.     info from Edward Schlunder to me.
  559.  
  560. ... to Sami Tammilehto (Psi/Future Crew) who documented the ScreamTracker 2
  561.     format so well. Please release ScreamTracker ]I[!  Nobody cares if it's
  562.     finished or not!
  563.  
  564. ... to Tomasz Pytel (Tran/Renaissance) who documented the Composer 669
  565.     format so well.
  566.  
  567. ... to Daniel Goldstein (Starscream/Renaissance) who documented the
  568.     MultiTracker Module format so well.
  569.  
  570. ... to Draeden/VLA for MODINFO.DOC and the accompanying ASM files that let
  571.     me know that I had been doing everything right all along!
  572.  
  573. Idea thanks:
  574.  
  575. ... to Eric Coolman for -
  576.     - letting me know about his MODs that weren't being identified
  577.     - reminding me to add AMF recognition
  578.     - calling to tell me that I forgot MODMAN.CFG in V1.0!
  579.     - asking for a return to 25-line mode when exiting MODMAN
  580.     - giving me the font-changing code
  581.       That code is REALLY USEFUL! Thanks Eric!
  582.       (This means I will probably NEVER support 25-line mode now!)
  583.     - doing the file x-fer thing with Andy Hakim.
  584.  
  585. ... to Mark Eramian for suggesting that MODMAN restart itself after
  586.     playing, and also because I found out about a *very* silly bug while
  587.     trying MODMAN on his computer!
  588.  
  589. ... to Hermann Samso for posting "How to set the palette in VGA mode 12h"
  590.     on comp.sys.ibm.pc.demos. He thanked Ben Castricum and Ed Robinson.
  591.  
  592. A long series of thanks:
  593.  
  594. ... to Toni Nikkanen for the info in the DMPShell documentation about
  595.     borrowing the 50-line video mode code from NNANSI.SYS
  596.  
  597. ... to Tom Almy for having the 50-line VGA mode code in NNANSI.SYS
  598.  
  599. ... to Daniel Kegel for allowing Tom Almy to use NANSI.SYS as a beginning
  600.     for NNANSI.SYS
  601.  
  602. ... to whoever wrote the standard ANSI.SYS for making it so badly that
  603.     Daniel Kegel wanted to improve on it!
  604.  
  605. ... to whoever left ANSI support out of the DOS kernel so that ANSI.SYS was
  606.     required!
  607.  
  608. And a big THANKS to Andy Hakim for SMD. See the OTHER STUFF section for
  609. more information on this fine product!
  610.  
  611.   ┌─────────────────╖
  612. ──┤ FUTURE FEATURES ╟──────────────────────────────────────────────────────
  613.   ╘═════════════════╝
  614.  
  615.     Features that are constantly being updated:
  616.  
  617.       - More MOD formats recognized
  618.       - Even more detailed docs and help screens
  619.       - Tight, fast code (not that anybody notices!)
  620.       - Any suggestions I get
  621.  
  622.     The future features below are listed in order of priority:
  623.  
  624.       - File copy/move/delete
  625.       - Save/load "album" type files
  626.         (so that the sequence can be restored upon return to MODMAN.)
  627.       - Edit module titles
  628.       - Sort module directory by filename/title/size/format/sequence
  629.  
  630.     Don't hold your breath for these ones:
  631.  
  632.       - Archive (ZIP/LHA/ARJ etc.) support
  633.       - Cross-directory selection
  634.       - Directory tree display for change directory
  635.       - 25-line text mode support
  636.  
  637.   ┌─────────╖
  638. ──┤ HISTORY ╟──────────────────────────────────────────────────────────────
  639.   ╘═════════╝
  640.  
  641. v0.5 - 1993.07.22 - Project started
  642.  
  643. v1.0 - 1993.08.05 - Initial release
  644.  
  645. v1.1 - 1993.08.06 - Boy do I feel stupid!
  646.                     - MODMAN.CFG is now included in the archive.
  647.  
  648.                   - New players in sample config:
  649.                     - JM ProTracker 5.1
  650.                     - DarkTracker 2.01
  651.                     - PowerPlayer 1.30
  652.  
  653. v1.2 - 1993.08.20 - New and improved features:
  654.                     - 0 or @ for "maximum of files on one command line"
  655.                       in MODMAN.CFG will make @listfile instead.
  656.                     - Up to 80 characters in config file command line.
  657.                       Batch files no longer required for most players!
  658.                     - * now selects only those mods which can be played
  659.                       using the selected player.
  660.  
  661.                   - Avoiding potential problems:
  662.                     - Temporary batch file constantly changes back to
  663.                       previous "current" directory throughout the batch
  664.                       file in case you shell to DOS while playing and
  665.                       forget to change back to the MOD directory.
  666.                     - Maximum number of modules reduced from 1536 to 1024.
  667.                       Nobody who is even remotely sane has more than 1024
  668.                       modules in one directory. This will ensure that even
  669.                       if you DO have more than 1024 modules in one
  670.                       directory, you will not be able to go over the limit
  671.                       of 1024 in a DMP @listfile!
  672.                     - MM.BAT Checks ERRORLEVEL (255=success, else error #)
  673.  
  674.                   - Cosmetic fixes:
  675.                     - Exciting scrollable help screen added.
  676.                     - Main screen quick-help bar improved.
  677.                     - Filenames now "split" at the '.' Filename left
  678.                       justified, extension right justified.
  679.                     - Switches back to 25-line mode upon exit if you start
  680.                       in less-than-50-line mode, otherwise doesn't change
  681.                       anything.
  682.  
  683.                   - New format recognitions:
  684.                     - ProTracker with > 64 channels
  685.                     - StarTrekker 4 channels
  686.                     - StarTrekker 8 channels
  687.                     - ModEdit
  688.  
  689.                   - Sample configuration changes:
  690.                     - No more batch files!
  691.                     - Format numbers changed - you'll have to reconfigure!
  692.  
  693.                   - Bug fixes:
  694.                     - MODMAN.CFG files with no CR or LF at end of last line
  695.                       now read properly.
  696.                     - Stays in same directory instead of exiting with error
  697.                       if you try to change to a directory containing no
  698.                       playable modules.
  699.  
  700. v1.3 - 1993.08.26 - New and improved features:
  701.                     - Search by filename with small letters
  702.                     - Search by title with capital letters
  703.                     - Dir, Random and Clear changed to Alt+D, R & C
  704.                     - Directory history added (a bit buggy but it works!)
  705.  
  706.                   - Cosmetic fixes:
  707.                     - Spiffy custom font (code courtesy of Eric Coolman)
  708.                     - Extremely 3-dimensional-looking help screens
  709.                     - Main screen quick-help bar expanded
  710.                     - Palette flashes at beginning and end of run
  711.                     - DMP fonts no longer included - I'm wondering if I
  712.                       should integrate them somehow...
  713.  
  714.                   - New format recognition:
  715.                     - StarTrekker 6 channels
  716.  
  717. v1.4 - 1993.09.01 - New and improved features:
  718.                     - Mouse support! See third help page in the program.
  719.                       Also refer to OTHER STUFF section for information on
  720.                       the SMD kit.
  721.  
  722.                   - Cosmetic fixes:
  723.                     - Even spiffier custom font
  724.                     - Overscan (border colour) restored on exit
  725.  
  726.                   - New format recognition:
  727.                     - AudioVision ROM file
  728.  
  729.                   - New player in sample config:
  730.                     - AudioVision ROM Player
  731.  
  732. v1.5 - 1993.09.25 - No new features, I just put my Internet address in this
  733.                     MODMAN.DOC file, the online help, and the FILE_ID.DIZ.
  734.                     See ABOUT THE AUTHOR for more info.
  735.  
  736. v1.6 - 1993.11.28 - New format recognition:
  737.                     - MultiTracker Module Editor
  738.  
  739. v1.7 - 1994.01.02 - New VGA palette bells & whistles. That's all!
  740.  
  741. ───────────────────────────────────────────────────────────────────────────
  742.